home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / X11 / showps.z / showps
Text File  |  1998-10-30  |  66KB  |  1,453 lines

  1.  
  2.  
  3.  
  4.      SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))          AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444))))           SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           showps - Adobe Systems PostScript language document
  10.           previewer.
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           sssshhhhoooowwwwppppssss [-usage] [-help] [-dis1] [-dis2] [-dis3] [-dis4]
  14.           [-ept] [-igc] [-maxp _s_i_z_e] [-mono] [-or _o_r_i_e_n_t_a_t_i_o_n] [-pro
  15.           _f_i_l_e] [-qfb] [-ps _p_a_g_e_s_i_z_e] [-repsf] [-pscan _s_i_z_e] [-sc
  16.           _s_c_a_l_e] [-sf] [-skipc] [-tdir _d_i_r] [-v] [-visual _v_i_s_u_a_l]
  17.           [-depth _d_e_p_t_h] [-wp] [-] [_f_i_l_e_s]
  18.  
  19.  
  20.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.           The Adobe ShowPS program displays PostScript language
  22.           documents in an X window, using the Display PostScript
  23.           extension in the X server.
  24.  
  25.           The program allows you to preview and page through both
  26.           structured and unstructured PostScript language documents.
  27.           You can choose the size, scale, and orientation of the
  28.           display.
  29.  
  30.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  31.           You can provide command line options in upper or lower case
  32.           (the argument to the ----ppppssss option is the only exception). The
  33.           options may appear in any order, but filenames must come
  34.           after all other options.  Instead of using an option, you
  35.           can often set an X resource or select a menu command to
  36.           achieve the same behavior change.  In that case:
  37.  
  38.              * Use the X resource to permanently set your preferred
  39.              default (see RESOURCES).
  40.  
  41.              * Use the option to override the resource setting for one
  42.              session.
  43.  
  44.              * Use the menu command to temporarily override the
  45.              resource or option setting (see USER INTERFACE).
  46.  
  47.           The Adobe ShowPS program supports all standard X toolkit
  48.           options described in the X(1) manual page. In addition, the
  49.           program supports the following options:
  50.  
  51.           ----uuuussssaaaaggggeeee
  52.  
  53.           ----hhhheeeellllpppp
  54.                Lists command syntax, command-line options summary, and
  55.                X resource for each option. The -help and -usage
  56.                command options are equivalent.
  57.  
  58.           ----vvvveeeerrrrssssiiiioooonnnn
  59.                Displays the version number of the ShowPS product.
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))          AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444))))           SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))
  71.  
  72.  
  73.  
  74.           ----rrrreeeettttaaaaiiiinnnn
  75.                (retain colors) If ShowPS allocates colors in the
  76.                default colormap, those colors, by default, do not
  77.                remain allocated in the colormap after ShowPS exits.
  78.                Instead, the entries are freed and made available for
  79.                other applications that use the default colormap.
  80.                However, if the -retain option is specified and ShowPS
  81.                has allocated colors in the default colormap, these
  82.                colors do remain allocated in the colormap after ShowPS
  83.                exits.
  84.  
  85.                If the visual is not the default visual, or if SHowPS
  86.                creates a separate colormap, then the allocated colors
  87.                are not retained, whether or not the -retain option is
  88.                specified and regardless of the value of
  89.                colormapRetainColors, the associated X resource.
  90.                Resource: colormapRetainColors
  91.                Defaults: False
  92.  
  93.           ----sssseeeeppppccccmmmmaaaapppp
  94.                (separate colormap) If the visual is not the default
  95.                visual, ShowPS allocates the Display PostScript
  96.                colorcube and grayramp in a separate colormap whether
  97.                or not the -sepcmap option is specified and regardless
  98.                of the value of colormapAllowSeparateMap.
  99.  
  100.                If the visual is the default visual, ShowPS first tries
  101.                to allocate the Display PostScript colorcube and
  102.                graymap in the default colormap. If the colorcube and
  103.                grayramp fit in the default colormap, then no further
  104.                action is taken. However, if there is not enough room,
  105.                then ShowPS either shrinks the colorcube and grayramp
  106.                until they fit in the default colormap or allocates a
  107.                separate colormap, according to the following rules:
  108.  
  109.                ShowPS shrinks the colorcube and grayramp if either of
  110.                the following conditions is true:
  111.  
  112.                * The selected visual is read-only (StaticGray,
  113.                StaticColor, or TrueColor).
  114.  
  115.                * The colormapAllowSeparate resource is set to False
  116.                and -sepcmap option is not specified.
  117.  
  118.                If neither of these conditions is true, ShowPS
  119.                allocates the Display PostScript colorcube and grayramp
  120.                in a separate colormap.
  121.  
  122.                Note that allowing ShowPS to create a separate colormap
  123.                can cause other applications to be shown in false
  124.                colors when the window manager's focus in on ShowPS.
  125.                Resource: colormapAllowSeparateMap
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))          AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444))))           SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))
  137.  
  138.  
  139.  
  140.                Default: True
  141.  
  142.           ----rrrreeeeddddssss _n_u_m_b_e_r
  143.                Sets the preferred number of red colors in the Display
  144.                PostScript colorcube.  Values of _n_u_m_b_e_r can be integers
  145.                0, 2-256. If the _n_u_m_b_e_r is zero, ShowPS uses resources
  146.                in your .Xdefaults file to determine what value to use.
  147.                For a detailed explanation, see _S_h_o_w_P_S _U_s_e_r _G_u_i_l_d,
  148.                installed as /usr/lib/DPS/doc/ShowPSUserGuide.ps,
  149.                Appendix D, in the section titled "Specifying zero as a
  150.                color value."
  151.                Resource: colormapReds
  152.                Default: 0
  153.  
  154.           ----ggggrrrreeeeeeeennnnssss _n_u_m_b_e_r
  155.                Sets the preferred number of green colors in the
  156.                Display PostScript colorcube.  Values of _n_u_m_b_e_r can be
  157.                integers 0, 2-256. If the _n_u_m_b_e_r is zero, ShowPS uses
  158.                resources in your .Xdefaults file to determine what
  159.                value to use.  For a detailed explanation, see _S_h_o_w_P_S
  160.                _U_s_e_r _G_u_i_l_d, installed as
  161.                /usr/lib/DPS/doc/ShowPSUserGuide.ps, Appendix D, in the
  162.                section titled "Specifying zero as a color value."
  163.                Resource: colormapGreens
  164.                Default: 0
  165.  
  166.           ----bbbblllluuuueeeessss _n_u_m_b_e_r
  167.                Sets the preferred number of blue colors in the Display
  168.                PostScript colorcube.  Values of _n_u_m_b_e_r can be integers
  169.                0, 2-256. If the _n_u_m_b_e_r is zero, ShowPS uses resources
  170.                in your .Xdefaults file to determine what value to use.
  171.                For a detailed explanation, see _S_h_o_w_P_S _U_s_e_r _G_u_i_l_d,
  172.                installed as /usr/lib/DPS/doc/ShowPSUserGuide.ps,
  173.                Appendix D, in the section titled "Specifying zero as a
  174.                color value."
  175.                Resource: colormapBlues
  176.                Default: 0
  177.  
  178.           ----ggggrrrraaaayyyyssss _n_u_m_b_e_r
  179.                Sets the preferred number of grays in the Display
  180.                PostScript colorcube.  Values of _n_u_m_b_e_r can be integers
  181.                0, 2-256. If the _n_u_m_b_e_r is zero, ShowPS uses resources
  182.                in your .Xdefaults file to determine what value to use.
  183.                For a detailed explanation, see _S_h_o_w_P_S _U_s_e_r _G_u_i_l_d,
  184.                Appendix D, in the section titled "Specifying zero as a
  185.                color value."
  186.                Resource: colormapGrays
  187.                Default: 0
  188.  
  189.           ----ddddiiiissss1111
  190.                (display option 1) Displays the Shortcut Panel at
  191.                startup for immediate access. The Shortcut Panel
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))          AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444))))           SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))
  203.  
  204.  
  205.  
  206.                contains commonly used File, Page, and Controls menu
  207.                commands.
  208.                Resource: displayShortcutPanelDialogAtStartup
  209.                Default: False
  210.  
  211.           ----ddddiiiissss2222
  212.                (display option 2) Displays the Scale Selection panel
  213.                at startup. The Scale Selection panel lets you enlarge
  214.                or reduce the displayed image.
  215.                Resource: displayScaleSelectionDialogAtStartup
  216.                Default: False
  217.  
  218.           ----ddddiiiissss3333
  219.                (display option 3) Displays the Page Selection panel at
  220.                startup. The Page Selection panel lets you select a
  221.                page for viewing.
  222.                Resource: displayPageSelectionDialogAtStartup
  223.                Default: False
  224.  
  225.           ----ddddiiiissss4444
  226.                (display option 4) Displays the Page Orientation panel
  227.                at startup.  The Page Orientation panel lets you change
  228.                the orientation of the page within the window.
  229.                Resource: displayPageOrientationDialogAtStartup
  230.                Default: False
  231.  
  232.           ----eeeepppptttt (emulate paper trays) Changes the page size when the
  233.                PostScript language document contains a request for a
  234.                different paper size. You need this option only if the
  235.                associated X resource, emulatePaperTrays, has been set
  236.                to False and you want to change the behavior.
  237.                Resource: emulatePaperTrays
  238.                Default: True
  239.  
  240.           ----iiiiggggcccc (ignore comments) Ignores all document structuring
  241.                convention (DSC) comments in a PostScript language
  242.                file, that is, treats the document as an unstructured
  243.                document. This can be helpful for viewing an
  244.                incorrectly structured document. See also filterps(1).
  245.                Resource: ignoreComments
  246.                Default: False
  247.  
  248.           ----mmmmaaaaxxxxpppp _s_i_z_e
  249.                When the program displays a page, it first writes the
  250.                whole page to an offscreen buffer called a pixmap, then
  251.                copies the buffer content to the window.  The ----mmmmaaaaxxxxpppp
  252.                option sets the maximum number of bytes of memory that
  253.                the program is allowed to allocate for that buffer. The
  254.                default value is 4 Mbytes.
  255.  
  256.                The _s_i_z_e parameter may be followed by `k` for kilobytes
  257.                or `m` for megabytes; for example, -maxp 3m. If _s_i_z_e is
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 4/30/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))          AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444))))           SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))
  269.  
  270.  
  271.  
  272.                zero, the program does not create a pixmap and draws
  273.                directly to the window. Final window size is based on
  274.                the page size specification and the scale factor. If
  275.                either the final window width or the final window
  276.                height exceeds 8 000 pixels, the program reduces the
  277.                scale factor.
  278.  
  279.                A large page size requires allocation of a substantial
  280.                amount of memory for the pixmap. If the memory required
  281.                for the pixmap exceeds the default or the limit set by
  282.                this option, the program displays a message and draws
  283.                directly to the window afterward. See EXCEEDING PIXMAP
  284.                MEMORY below.
  285.  
  286.                If you increase the value of the _s_i_z_e parameter beyond
  287.                the default, the previewer may slow down when you
  288.                increase the scale factor.  This is caused by increased
  289.                paging in the system when the X server allocates a
  290.                large pixmap.
  291.                Resource: maxPixmapBytes
  292.                Default: 4000000
  293.  
  294.           ----mmmmoooonnnnoooo
  295.                Displays documents as they would appear on a monochrome
  296.                printer. This may improve performance of the previewer,
  297.                since monochrome documents require a much smaller
  298.                pixmap. You can choose between optimum performance and
  299.                optimum display quality:
  300.  
  301.                * Consider using ----mmmmoooonnnnoooo to enhance performance if you
  302.                are previewing monochrome documents on a color display.
  303.  
  304.                * Don`t use ----mmmmoooonnnnoooo if memory or speed are not an issue;
  305.                this gets you the highest quality display on all
  306.                monitors.
  307.  
  308.                Resource: monochrome
  309.                Default: False
  310.  
  311.           ----oooorrrr _o_r_i_e_n_t_a_t_i_o_n
  312.                Sets the page orientation to the specified value. Valid
  313.                choices are:
  314.  
  315.                * portrait - The "normal" upright orientation
  316.                * landscape - The page rotated 90 degrees clockwise
  317.                * flip_portrait - The page rotated 180 degrees clockwise
  318.                * flip_landscape - The page rotated 270 degrees clockwise
  319.  
  320.                Resource: pageOrientation
  321.                Default: portrait
  322.  
  323.           ----pppprrrroooo _f_i_l_e
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 4/30/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))          AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444))))           SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))
  335.  
  336.  
  337.  
  338.                Sets the pathname to an external PostScript prolog
  339.                file. The previewer sends this file to the Display
  340.                PostScript context after the internal prolog and before
  341.                the PostScript file.
  342.  
  343.                This option can be used to implement stubs for site-
  344.                specific ssssttttaaaattttuuuussssddddiiiicccctttt operators, which may be used in
  345.                PostScript files at certain sites.
  346.                Resource: prologFile
  347.                Default: none
  348.  
  349.           ----ppppssss _p_a_g_e_s_i_z_e
  350.                Specifies the size of the drawing area. _p_a_g_e_s_i_z_e can be
  351.                the name of a standard page size (ledger, b, c0, and so
  352.                on) or two numbers, separated by a colon, that define
  353.                the width and height of a custom page. The default page
  354.                size is 8.5 x 11 inches.  Possible values for the
  355.                pagesize argument include:
  356.  
  357.                * a, b, c, d, e, f, or e1 (American ANSI)
  358.                * a0, a1, ... a10 (metric ISO)
  359.                * b0, b1, ... b10 (metric ISO)
  360.                * c0, c1, ... c7 (metric ISO)
  361.                * width:height (custom size)
  362.  
  363.                Width and height are by default specified in inches and
  364.                may be integers or floating-point numbers. To specify
  365.                units other than inches, follow the number with:
  366.  
  367.                * cm to specify centimeters
  368.                * mm to specify millimeters
  369.                * px to specify pixels
  370.                * pt to specify points
  371.  
  372.                Other values for the pagesize argument are supported
  373.                for convenience.  Examples are:  legal (8.5 x 14),
  374.                ledger (11 x 17), and executive (7.25 x 10.50).
  375.  
  376.                Case is significant when specifying arguments to the
  377.                -ps option. In many instances, upper-case arguments
  378.                designate 90 degree rotated versions of the lower case
  379.                arguments. For example, lllleeeetttttttteeeerrrr designates a page size
  380.                of 8.5 x 11 inches, while LLLLeeeetttttttteeeerrrr designates a page size
  381.                of 11 x 8.5 inches. To view a complete list of all the
  382.                supported values for the pagesize argument, use the
  383.                ----hhhheeeellllpppp option, or consult the _A_d_o_b_e _S_h_o_w_P_S _U_s_e_r _G_u_i_d_e.
  384.  
  385.                If you choose a page size too small for the current
  386.                page, the effect is the same as if you used a paper
  387.                size too small for a document you print. The program
  388.                displays as much of the document as fits on the page
  389.                but does not provide scroll bars. To view the whole
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 4/30/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))          AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444))))           SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))
  401.  
  402.  
  403.  
  404.                page, choose a large enough page size, then scroll or
  405.                scale the document as needed if it is larger than the
  406.                window.
  407.                Resource: pageSize
  408.                Default: letter
  409.  
  410.           ----ppppssssccccaaaannnn _s_i_z_e
  411.                (pre-scan size) Certain applications prepend sequences
  412.                of control characters and other text strings to the
  413.                PostScript files they generate. When the previewer
  414.                opens such a file, it searches through the first _s_i_z_e
  415.                characters for the PostScript identifier string ``%!''.
  416.                If found, the previewer starts rendering the PostScript
  417.                file starting at the file offset where the identifier
  418.                was found. If not found, the previewer assumes that the
  419.                identifier starts at the character immediately
  420.                following the first _s_i_z_e characters of the file. If the
  421.                identifier string is missing, the previewer displays a
  422.                dialog box that asks whether to display the file
  423.                anyway.
  424.  
  425.                The _s_i_z_e parameter may be followed by k for Kbytes and
  426.                m for Mbytes. If _s_i_z_e is greater than 100 Mbytes, an
  427.                error message results. If _s_i_z_e is zero, the previewer
  428.                skips the pre-scan and assumes that the PostScript
  429.                identifier string starts in the first position in the
  430.                first line of the file. The default value is 8200,
  431.                which allows for the common case where the header size
  432.                is 8192 bytes.
  433.                Resource: preScanSize
  434.                Default: 8200
  435.  
  436.           ----rrrreeeeppppssssffff
  437.                (reposition EPS files) Encapsulated PostScript (EPS)
  438.                files can contain images at an arbitrary location on
  439.                the page. By default, the previewer aligns the upper
  440.                left corner of the image with the upper left corner of
  441.                the page. If the associated resource (repositionEPSF)
  442.                has been changed to False, you can use the ----rrrreeeeppppssssffff
  443.                option to return to the default behavior.
  444.                Resource: repositionEPSF
  445.                Default: True
  446.  
  447.           ----qqqqffffbbbb (quiet fall back) When set, ShowPS falls back to
  448.                unstructured mode if it cannot find %%Page comments in
  449.                the PostScript file being viewed. When not set, a
  450.                message window appears to alert the user that the file
  451.                is not structured.
  452.                Resource: quietFallback
  453.                Default: True
  454.  
  455.           ----sssscccc _s_c_a_l_e
  456.  
  457.  
  458.  
  459.      Page 7                                          (printed 4/30/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))          AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444))))           SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))
  467.  
  468.  
  469.  
  470.                Sets a scale factor which applies to the page size and
  471.                to the drawing on the page. The scale factor may be an
  472.                integer or a floating point number. The default value
  473.                for the scale factor is 1 (one). The legal range is 0.1
  474.                through 10.0.
  475.                Resource: scale
  476.                Default: 1.0
  477.  
  478.           ----ssssffff  (substitute fonts) Substitutes Courier font if a
  479.                document requires a font that is not available.
  480.                You need this option only if you have changed the value
  481.                of the substituteFonts resource to False. In that case,
  482.                the previewer displays an error message if you try to
  483.                load a file that requires unavailable fonts and the X
  484.                server does not provide font substitution. A message
  485.                explains why the previewer cannot load the file.
  486.                Resource: substituteFonts
  487.                Default: True
  488.  
  489.           ----sssskkkkiiiippppcccc
  490.                (skip copyright) Skips the copyright notice that is
  491.                usually displayed when you start the program.
  492.                Resource: skipCopyright
  493.                Default: True
  494.  
  495.           ----ttttddddiiiirrrr _d_i_r
  496.                When the program reads from _s_t_d_i_n, it temporarily
  497.                stores the input from _s_t_d_i_n in the directory specified
  498.                by the _t_e_m_p_D_i_r resource (_t_m_p by default) and later
  499.                removes it. Use this option to specify a different
  500.                directory for storing the input.
  501.                Resource: tempDir
  502.                Default: /tmp
  503.  
  504.           ----vvvv   (verbose) Prints a short message to _s_t_d_e_r_r each time an
  505.                error dialog box is displayed. This allows you to save
  506.                error messages to a file for later inspection and
  507.                debugging.
  508.                Resource: verbose
  509.                Default: False
  510.  
  511.           ----wwwwpppp  (watch progress) By default, the program writes a page
  512.                to a pixmap and displays it only when it is complete.
  513.                When you use the ----wwwwpppp option, the program displays parts
  514.                of the page as it is being drawn. While the option lets
  515.                you observe the progress of a display that requires
  516.                lengthy preparation, the order in which chunks are
  517.                displayed is not meaningful.
  518.                Resource: watchProgress
  519.                Default: False
  520.  
  521.           ----    If you supply "-" instead of a filename, the program
  522.  
  523.  
  524.  
  525.      Page 8                                          (printed 4/30/98)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))          AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444))))           SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))
  533.  
  534.  
  535.  
  536.                reads from _s_t_d_i_n. In that case, the program temporarily
  537.                stores the input from _s_t_d_i_n in the directory specified
  538.                by the _t_e_m_p_D_i_r resource and later removes it.
  539.  
  540.                The "-" option makes it possible to view plain text
  541.                files.  Run the file through a program that generates
  542.                PostScript language output and pipe the output to the
  543.                previewer's _s_t_d_i_n.
  544.  
  545.           _f_i_l_e_s
  546.                Loads one or more files into the previewer at startup
  547.                time.
  548.  
  549.      DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTT RRRREEEEQQQQUUUUIIIIRRRREEEEMMMMEEEENNNNTTTTSSSS
  550.           If a document uses the PostScript language incorrectly, the
  551.           program may not be able to display it.
  552.  
  553.           A file type should be indicated on the first line of the
  554.           document, even if it is a hand-coded PostScript language
  555.           file. An unstructured document is indicated by a percent
  556.           sign directly followed by an exclamation point (%!).  If the
  557.           ``%!'' characters are not found on the first line of the
  558.           file, the previewer will open a dialog window in which you
  559.           can specify the file as an unstructured PostScript document.
  560.  
  561.         SSSSTTTTRRRRUUUUCCCCTTTTUUUURRRREEEEDDDD AAAANNNNDDDD UUUUNNNNSSSSTTTTRRRRUUUUCCCCTTTTUUUURRRREEEEDDDD DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTSSSS
  562.           The ShowPS program does not require a structured PostScript
  563.           language document, as defined in Appendix G of the
  564.           _P_o_s_t_S_c_r_i_p_t _L_a_n_g_u_a_g_e _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, _S_e_c_o_n_d _E_d_i_t_i_o_n.
  565.  
  566.           When you view an unstructured document you cannot go
  567.           directly to a page, but you can page forward through the
  568.           document and return to the first page.  The program displays
  569.           a trailing blank page at the end of each unstructured
  570.           document.
  571.  
  572.           If a document uses DSC comments incorrectly, the program may
  573.           not be able to display it or may display it as an
  574.           unstructured document. You can use the ffffiiiilllltttteeeerrrrppppssss utility to
  575.           convert some documents to correctly structured documents.
  576.  
  577.         SSSSPPPPEEEECCCCIIIIAAAALLLL DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTSSSS
  578.           The program detects structured documents whose pages have
  579.           been placed in reverse order and displays the pages in
  580.           normal order.
  581.  
  582.           When you view a standalone Encapsulated PostScript (EPS)
  583.           file the program displays the file with its top left corner
  584.           in the top left corner of the window. This reduces
  585.           unnecessary scrolling. You can use the _r_e_p_o_s_i_t_i_o_n_E_P_S_F
  586.           resource, the rrrreeeeppppssssffff option, or the RRRReeeeppppoooossssiiiittttiiiioooonnnn EEEEPPPPSSSS FFFFiiiilllleeeessss
  587.           command in the OOOOppppttttiiiioooonnnnssss menu to change this behavior.
  588.  
  589.  
  590.  
  591.      Page 9                                          (printed 4/30/98)
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))          AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444))))           SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))
  599.  
  600.  
  601.  
  602.      EEEEXXXXCCCCEEEEEEEEDDDDIIIINNNNGGGG PPPPIIIIXXXXMMMMAAAAPPPP MMMMEEEEMMMMOOOORRRRYYYY
  603.           When the Adobe ShowPS program displays a page, it first
  604.           draws the whole page to a pixmap. By default, the program
  605.           allocates 4 Mbytes of memory for the pixmap. The exact
  606.           number depends on  the machine on which you have the
  607.           display. You can change the upper limit with the ----mmmmaaaaxxxxpppp
  608.           option.
  609.  
  610.           A large page size, whether requested by the ----ppppssss option or by
  611.           a command in the PostScript language document, requires
  612.           allocation of a substantial amount of memory.  For example,
  613.           on a machine that displays 100 dots per linear inch, each
  614.           square inch has 10 000 dots. If the machine is an 8-bit
  615.           color machine, 10 kilobytes are needed for each square inch
  616.           of the page.
  617.  
  618.           If the combination of the requested page size and scale
  619.           factor require pixmap memory that exceeds the upper limit,
  620.           the program does not allocate a pixmap but draws directly to
  621.           the window instead. In that case, the program displays a
  622.           warning message. Whether this message is displayed again
  623.           depends on the action you take:
  624.  
  625.              * If you reduce the scale factor but the required pixmap
  626.              storage still exceeds the number specified by the ----mmmmaaaaxxxxpppp
  627.              option, the message is displayed again.  This helps you
  628.              determine how far the scale factor has to be reduced.
  629.  
  630.              * If you increase the scale factor, the message is not
  631.              redisplayed, since you already know there is not enough
  632.              space. This prevents the message from popping up
  633.              repeatedly as you move the scale slider.
  634.  
  635.              * If you don't reduce the scale factor and open another
  636.              file, that file won't have a pixmap either. Since you
  637.              have been informed already, no message is displayed.
  638.  
  639.           After you have acknowledged the message, structured
  640.           documents are drawn directly to the window. If you are
  641.           viewing an unstructured document, the previewer can display
  642.           only the part of the page that was in the viewing area and
  643.           not covered by other panels. You have two options:
  644.  
  645.              (1) Decrease the scale factor until the previewer can
  646.              allocate a pixmap again, using the error messages as a
  647.              guide.
  648.  
  649.              (2) Scroll the page to view the area you want to examine,
  650.              then choose RRRReeeeooooppppeeeennnn from the FFFFiiiilllleeee menu and page forward to
  651.              the information you want to see.
  652.  
  653.      KKKKEEEEYYYYBBBBOOOOAAAARRRRDDDD AAAACCCCCCCCEEEELLLLEEEERRRRAAAATTTTOOOORRRRSSSS
  654.  
  655.  
  656.  
  657.      PPPPaaaaggggeeee 11110000                                         ((((pppprrrriiiinnnntttteeeedddd 4444////33330000////99998888))))
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.      SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))          AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444))))           SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))
  665.  
  666.  
  667.  
  668.         FFFFiiiilllleeee MMMMeeeennnnuuuu
  669.           Previous Crtl+V
  670.           Next Crtl+N
  671.           Open... Crtl+O
  672.           Reopen Crtl+R
  673.           Print... Crtl+P
  674.           Exit Crtl+Q
  675.  
  676.         PPPPaaaaggggeeee MMMMeeeennnnuuuu
  677.           Previous Page Crtl+B, b, p, PageUp
  678.           Next Page Crtl+F, f, n, Return, spacebar, PageDown
  679.           Last Page Viewed Crtl+L
  680.           Redraw Page Crtl+D
  681.           Page Selection... Crtl+P
  682.           Notes: Press 'Home' to display first page and 'End' to display last page.
  683.  
  684.         BBBBooooooookkkkmmmmaaaarrrrkkkkssss MMMMeeeennnnuuuu
  685.           Previous Bookmark Crtl+E
  686.           Next Bookmark Crtl+X
  687.           Bookmark Info... Crtl+I
  688.           Mark/Unmark Page Crtl+K, m
  689.  
  690.         VVVViiiieeeewwww MMMMeeeennnnuuuu
  691.           Shortcut Panel... Crtl+C
  692.           Scale Selection... Crtl+S
  693.           Page Orientation... Crtl+T
  694.  
  695.      PPPPAAAAGGGGEEEE SSSSIIIIZZZZEEEESSSS
  696.           Page size options include page sizes defined by the user and
  697.           the following international standard page sizes:
  698.  
  699.           MMMMeeeettttrrrriiiicccc IIIISSSSOOOO AAAA ssssiiiizzzzeeeessss::::
  700.           a0  841.0 x 1189.0 mm (33.11 x 46.81 in)
  701.           a1  594.0 x  841.0 mm (23.39 x 33.11 in)
  702.           a2  420.0 x  594.0 mm (16.54 x 23.39 in)
  703.           a3  297.0 x  420.0 mm (11.69 x 16.54 in)
  704.           a4  210.0 x  297.0 mm ( 8.27 x 11.69 in)
  705.           a5  148.0 x  210.0 mm ( 5.83 x  8.27 in)
  706.           a6  105.0 x  148.0 mm ( 4.13 x  5.83 in)
  707.           a7   74.0 x  105.0 mm ( 2.91 x  4.13 in)
  708.           a8   52.0 x   74.0 mm ( 2.05 x  2.91 in)
  709.           a9   37.0 x   52.0 mm ( 1.46 x  2.05 in)
  710.           a10  26.0 x   37.0 mm ( 1.02 x  1.46 in)
  711.  
  712.           MMMMeeeettttrrrriiiicccc IIIISSSSOOOO BBBB ssssiiiizzzzeeeessss::::
  713.           b0  1000.0 x 1414.0 mm (39.37 x 55.67 in)
  714.           b1  707.0  x 1000.0 mm (27.83 x 39.37 in)
  715.           b2  500.0  x  707.0 mm (19.68 x 27.83 in)
  716.           b3  353.0  x  500.0 mm (13.90 x 19.68 in)
  717.           b4  250.0  x  353.0 mm ( 9.84 x 13.90 in)
  718.           b5  176.0  x  250.0 mm ( 6.93 x  9.84 in)
  719.           b6  125.0  x  176.0 mm ( 4.92 x  6.93 in)
  720.  
  721.  
  722.  
  723.      Page 11                                         (printed 4/30/98)
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.      SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))          AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444))))           SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))
  731.  
  732.  
  733.  
  734.           b7  88.0   x  125.0 mm ( 3.46 x  4.92 in)
  735.           b8  62.0   x   88.0 mm ( 2.44 x  3.46 in)
  736.           b9  44.0   x   62.0 mm ( 1.73 x  2.44 in)
  737.           b10 31.0   x   44.0 mm ( 1.22 x  1.73 in)
  738.  
  739.           MMMMeeeettttrrrriiiicccc IIIISSSSOOOO CCCC ssssiiiizzzzeeeessss::::
  740.           c0 914.4 x 1300.5 mm (36.00 x 51.20 in)
  741.           c1 650.2 x  914.4 mm (25.60 x 36.00 in)
  742.           c2 457.2 x  650.2 mm (18.00 x 25.60 in)
  743.           c3 325.1 x  457.2 mm (12.80 x 18.00 in)
  744.           c4 228.6 x  325.1 mm ( 9.00 x 12.80 in)
  745.           c5 162.6 x  228.6 mm ( 6.40 x  9.00 in)
  746.           c6 114.3 x  162.6 mm ( 4.50 x  6.40 in)
  747.           c7  81.3 x  114.3 mm ( 3.20 x  4.50 in)
  748.  
  749.           AAAAmmmmeeeerrrriiiiccccaaaannnn AAAANNNNSSSSIIII ssssiiiizzzzeeeessss::::
  750.           a   8.5 x 11.0 in ( 215.9 x  279.4 mm)
  751.           b  11.0 x 17.0 in ( 279.4 x  431.8 mm)
  752.           c  17.0 x 22.0 in ( 431.8 x  558.8 mm)
  753.           d  22.0 x 34.0 in ( 558.8 x  863.6 mm)
  754.           e  34.0 x 44.0 in ( 863.6 x 1117.6 mm)
  755.           f  28.0 x 40.0 in ( 711.2 x 1016.0 mm)
  756.           e1 44.0 x 68.0 in (1117.6 x 1727.2 mm)
  757.  
  758.  
  759.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  760.           To load two files into the previewer, the first a document
  761.           in the current directory, the second from /_u_s_r/_l_o_c_a_l/_d_o_c_s:
  762.  
  763.           %%%% sssshhhhoooowwwwppppssss mmmmyyyyddddoooocccc....ppppssss ////uuuussssrrrr////llllooooccccaaaallll////ddddooooccccssss////mmmmaaaannnnuuuuaaaallll....ppppssss
  764.  
  765.           To view the plain text file _s_t_o_r_y._t_x_t, run the file through
  766.           a program that generates PostScript language output and pipe
  767.           the output to the previewer's _s_t_d_i_n.  The following example
  768.           uses the eeeennnnssssccccrrrriiiipppptttt program from Adobe Systems Incorporated.
  769.  
  770.           %%%% eeeennnnssssccccrrrriiiipppptttt ----pppp ---- ssssttttoooorrrryyyy....ttttxxxxtttt |||| sssshhhhoooowwwwppppssss ----
  771.  
  772.           To load a file at double scale:
  773.  
  774.           %%%% sssshhhhoooowwwwppppssss ----sssscccc 2222 _f_i_l_e_n_a_m_e
  775.  
  776.           To start the program for viewing a4 documents:
  777.  
  778.           %%%% sssshhhhoooowwwwppppssss ----ppppssss aaaa4444
  779.  
  780.           To start the program for viewing documents 30 cm high by 20
  781.           cm wide:
  782.  
  783.           %%%% sssshhhhoooowwwwppppssss ----ppppssss 22220000ccccmmmm::::33330000ccccmmmm
  784.  
  785.           To set a maximum pixmap size of 5 Mbytes:
  786.  
  787.  
  788.  
  789.      Page 12                                         (printed 4/30/98)
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.      SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))          AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444))))           SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))
  797.  
  798.  
  799.  
  800.           %%%% sssshhhhoooowwwwppppssss ----mmmmaaaaxxxxpppp 5555mmmm
  801.  
  802.      FFFFIIIILLLLEEEESSSS
  803.           The name of the application defaults file for the Adobe
  804.           ShowPS program is _S_h_o_w_p_s. This file should be changed by the
  805.           system administrator only. Many of the widgets used by the
  806.           program get their resources from this file. The file must be
  807.           in one of the directories specified by the XFILESEARCHPATH
  808.           environment variable. If your site requires the use of a
  809.           custom prolog file, the system administrator should set the
  810.           value of the prologFile resource in the _S_h_o_w_p_s file.
  811.  
  812.           There are 3 PostScript documents that further explain
  813.           ShowPS:
  814.           _S_h_o_w_P_S _U_s_e_r _G_u_i_l_d : /usr/lib/DPS/doc/ShowPSUserGuide.ps
  815.           _S_h_o_w_P_S _R_e_f_e_r_e_n_c_e _C_a_r_d : /usr/lib/DPS/doc/ShowPSReferenceCard.ps
  816.           _S_h_o_w_P_S _B_r_o_c_h_u_r_e : /usr/lib/DPS/doc/ShowPS_Brochure.ps
  817.  
  818.           To override any of the resources, set them in your ._X_d_e_f_a_u_l_t_s file.
  819.  
  820.      RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
  821.           The program understands standard Motif resource names and
  822.           classes. In addition, the following  resources allow
  823.           application-specific customization.
  824.  
  825.           _c_o_l_o_r_m_a_p_R_e_t_a_i_n_C_o_l_o_r_s
  826.              Type: boolean; Default: False
  827.              Option: ----rrrreeeettttaaaaiiiinnnn
  828.  
  829.              Description:  If ShowPS allocates colors in the default
  830.                     colormap, those colors, by default, do not remain
  831.                     allocated in the colormap after ShowPS exits.
  832.                     Instead, the colormap entries are freed and made
  833.                     available for other applications that use the
  834.                     default colormap. However, if the
  835.                     colormapRetainColors resource is set to True and
  836.                     ShowPS has allocated colors in the default
  837.                     colormap, those colors remain allocated in the
  838.                     colormap after ShowPS exits. If the visual is not
  839.                     the default visual, or if ShowPS creates a
  840.                     separate colormap, then the allocated colors are
  841.                     not retained, regardless of the value of the
  842.                     resource or the specification of the associated
  843.                     command-line option, ----rrrreeeettttaaaaiiiinnnn.
  844.  
  845.           _c_o_l_o_r_m_a_p_A_l_l_o_w_S_e_p_a_r_a_t_e_M_a_p
  846.              Type: boolean; Default: False
  847.              Option: ----sssseeeeppppccccmmmmaaaapppp
  848.  
  849.              Description:  If the visual is not the default visual,
  850.                     ShowPS allocates the Display PostScript colorcube
  851.                     and grayramp in a separate colormap whether or not
  852.  
  853.  
  854.  
  855.      Page 13                                         (printed 4/30/98)
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.      SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))          AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444))))           SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))
  863.  
  864.  
  865.  
  866.                     the -sepcmap option is specified and regardless of
  867.                     the value of this resource.
  868.  
  869.                     If the visual is the default visual, ShowPS first
  870.                     tries to allocate the Display PostScript colorcube
  871.                     and grayramp in the default colormap. If the
  872.                     colorcube and grayramp fit in the default
  873.                     colormap, then no further action is taken.
  874.                     However, if there is not enough room, then ShowPS
  875.                     either shrinks the colorcube and grayramp until
  876.                     they fit in the default colormap or allocates a
  877.                     separate colormap, according to the following
  878.                     rules:
  879.  
  880.                     ShowPS shrinks the colorcube and grayramp if
  881.                     either of the following conditions is true:
  882.  
  883.                     * The selected visual is read-only (StaticGray,
  884.                     StaticColor, or TrueColor).
  885.  
  886.                     * The colormapAllowSeparateMap resource is set to
  887.                     False and the -sepcmap option is not specified.
  888.  
  889.                     If neither of these conditions is true, ShowPS
  890.                     allocates the Display PostScript colorcube and
  891.                     grayramp in a separate colormap.
  892.  
  893.                     Note that allowing ShowPS to create a separate
  894.                     colormap can cause other applications to be shown
  895.                     in false colors when the window manager's focus is
  896.                     on ShowPS.
  897.  
  898.           _c_o_l_o_r_m_a_p_R_e_d_s
  899.              Type: integer; Default: 0
  900.              Option: ----rrrreeeeddddssss _n_u_m_b_e_r
  901.  
  902.              Description:  Sets the preferred number of red colors in
  903.                     the Display PostScript colorcube.  Values for the
  904.                     argument can be integers 0, 2-256.  If the value
  905.                     for this resource is zero, ShowPS uses resources
  906.                     in your .Xdefaults file to determine what value to
  907.                     use. For a detailed explanation, see _S_h_o_w_P_S _U_s_e_r
  908.                     _G_u_i_d_e, Appendix D, in the section titled
  909.                     "Specifying zero as a color value."
  910.  
  911.           _c_o_l_o_r_m_a_p_G_r_e_e_n_s
  912.              Type: integer; Default: 0
  913.              Option: ----ggggrrrreeeeeeeennnnssss _n_u_m_b_e_r
  914.  
  915.              Description:  Sets the preferred number of green colors
  916.                     in the Display PostScript colorcube.  Values for
  917.                     the argument can be integers 0, 2-256.  If the
  918.  
  919.  
  920.  
  921.      Page 14                                         (printed 4/30/98)
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.      SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))          AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444))))           SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))
  929.  
  930.  
  931.  
  932.                     value for this resource is zero, ShowPS uses
  933.                     resources in your .Xdefaults file to determine
  934.                     what value to use. For a detailed explanation, see
  935.                     _S_h_o_w_P_S _U_s_e_r _G_u_i_d_e, Appendix D, in the section
  936.                     titled "Specifying zero as a color value."
  937.  
  938.           _c_o_l_o_r_m_a_p_B_l_u_e_s
  939.              Type: integer; Default: 0
  940.              Option: ----bbbblllluuuueeeessss _n_u_m_b_e_r
  941.  
  942.              Description:  Sets the preferred number of blue colors in
  943.                     the Display PostScript colorcube.  Values for the
  944.                     argument can be integers 0, 2-256.  If the value
  945.                     for this resource is zero, ShowPS uses resources
  946.                     in your .Xdefaults file to determine what value to
  947.                     use. For a detailed explanation, see _S_h_o_w_P_S _U_s_e_r
  948.                     _G_u_i_d_e, Appendix D, in the section titled
  949.                     "Specifying zero as a color value."
  950.  
  951.           _c_o_l_o_r_m_a_p_G_r_a_y_s
  952.              Type: integer; Default: 0
  953.              Option: ----ggggrrrraaaayyyyssss _n_u_m_b_e_r
  954.  
  955.              Description:  Sets the preferred number of gray values in
  956.                     the Display PostScript colorcube.  Values for the
  957.                     argument can be integers 0, 2-256.  If the value
  958.                     for this resource is zero, ShowPS uses resources
  959.                     in your .Xdefaults file to determine what value to
  960.                     use. For a detailed explanation, see _S_h_o_w_P_S _U_s_e_r
  961.                     _G_u_i_d_e, Appendix D, in the section titled
  962.                     "Specifying zero as a color value."
  963.           _d_i_s_p_l_a_y_S_h_o_r_t_c_u_t_P_a_n_e_l_D_i_a_l_o_g_A_t_S_t_a_r_t_u_p
  964.              Type: boolean; Default: False
  965.              Option: ----ddddiiiissss1111; Menu: Shortcut Panel
  966.  
  967.              Description: Instructs the previewer to open the Shortcut
  968.                     Panel at startup. The Shortcut Panel contains
  969.                     commonly used File, Page, and Controls menu
  970.                     commands.
  971.  
  972.           _d_i_s_p_l_a_y_S_c_a_l_e_S_e_l_e_c_t_i_o_n_D_i_a_l_o_g_A_t_S_t_a_r_t_u_p
  973.              Type: boolean; Default: False
  974.              Option: ----ddddiiiissss2222; Menu: Scale Selection
  975.  
  976.              Description: Instructs the previewer to open the Scale
  977.                     Selection panel at startup. The Scale Selection
  978.                     panel lets you enlarge or reduce the displayed
  979.                     image.
  980.  
  981.           _d_i_s_p_l_a_y_P_a_g_e_S_e_l_e_c_t_i_o_n_D_i_a_l_o_g_A_t_S_t_a_r_t_u_p
  982.              Type: boolean; Default: False
  983.              Option: ----ddddiiiissss3333; Menu: Page Selection
  984.  
  985.  
  986.  
  987.      Page 15                                         (printed 4/30/98)
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.      SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))          AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444))))           SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))
  995.  
  996.  
  997.  
  998.              Description: Instructs the previewer to open the Page
  999.                     Selection panel at startup. The Page Selection
  1000.                     panel lets you select a page for viewing.
  1001.  
  1002.           _d_i_s_p_l_a_y_P_a_g_e_O_r_i_e_n_t_a_t_i_o_n_D_i_a_l_o_g_A_t_S_t_a_r_t_u_p
  1003.              Type: boolean; Default: False
  1004.              Option: ----ddddiiiissss4444; Menu: Page Orientation
  1005.  
  1006.              Description: Instructs the previewer to open the Page
  1007.                     Orientation panel at startup. The Page Orientation
  1008.                     panel lets you change the orientation of the page
  1009.                     within the window.
  1010.  
  1011.           _e_m_u_l_a_t_e_P_a_p_e_r_T_r_a_y_s
  1012.              Type: boolean; Default: True
  1013.              Option: ----eeeepppptttt; Menu: Emulate Paper Trays
  1014.  
  1015.              Description: Instructs the program to honor requests for
  1016.                     paper tray changes that come from the PostScript
  1017.                     language document itself by using a different size
  1018.                     display when the document calls for a different
  1019.                     size paper. When set to False, the program ignores
  1020.                     paper tray requests.
  1021.  
  1022.           _i_g_n_o_r_e_C_o_m_m_e_n_t_s
  1023.              Type: boolean; Default: False
  1024.              Option: ----iiiiggggcccc; Menu: Ignore Comments
  1025.  
  1026.              Description:  Instructs the program to ignore any DSC
  1027.                     comments it finds in a document and to treat the
  1028.                     document as unstructured.
  1029.  
  1030.           _m_a_x_P_i_x_m_a_p_B_y_t_e_s
  1031.              Type: integer; Default: 4 Mbytes
  1032.              Option: ----mmmmaaaaxxxxpppp
  1033.  
  1034.              Description:  Allows you to set the maximum number of
  1035.                     bytes allowed for the pixmap that the program
  1036.                     draws to before displaying a page. See the ----mmmmaaaaxxxxpppp
  1037.                     option for more information. In contrast to the
  1038.                     ----mmmmaaaaxxxxpppp option, the value of this resource must be
  1039.                     an integer. Scale factors (m and k) cannot be
  1040.                     used.
  1041.  
  1042.           _m_o_n_o_c_h_r_o_m_e
  1043.              Type: boolean; Default: False
  1044.              Option: ----mmmmoooonnnnoooo; Menu: Monochrome
  1045.  
  1046.              Description: Instructs the program to display documents
  1047.                     in monochrome even on a color display. This
  1048.                     simulates the effect of printing on a monochrome
  1049.                     printer.
  1050.  
  1051.  
  1052.  
  1053.      Page 16                                         (printed 4/30/98)
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.      SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))          AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444))))           SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))
  1061.  
  1062.  
  1063.  
  1064.           _p_a_g_e_O_r_i_e_n_t_a_t_i_o_n
  1065.              Type: string; Default: portrait
  1066.              Option: ----oooorrrr; Menu: Page Orientation
  1067.  
  1068.              Description: Allows you to select the initial orientation
  1069.                     of a previewed page.  Possible settings are
  1070.                     portrait, landscape, flip_portrait,
  1071.                     flip_landscape.
  1072.  
  1073.           _p_a_g_e_S_i_z_e
  1074.              Type: string; Default: letter
  1075.              Option: ----ppppssss
  1076.  
  1077.              Description:  Allows you to set the default page size.
  1078.                     See PAGE SIZES for a list of standard page sizes.
  1079.  
  1080.           _p_r_e_S_c_a_n_S_i_z_e
  1081.              Type: integer; Default: 8200
  1082.              Option: ----ppppssssccccaaaannnn
  1083.  
  1084.              Description:  Certain applications prepend sequences of
  1085.                     control characters and other text strings to the
  1086.                     PostScript files they generate. When the previewer
  1087.                     opens such a file, it searches through the first
  1088.                     _p_r_e_S_c_a_n_S_i_z_e characters for the PostScript
  1089.                     identifier string ``%!''. If found, the previewer
  1090.                     starts rendering the PostScript file starting at
  1091.                     the file offset where the identifier was found. If
  1092.                     not found, the previewer assumes that the
  1093.                     identifier starts at the character immediately
  1094.                     following the first _p_r_e_S_c_a_n_S_i_z_e characters of the
  1095.                     file. If the identifier string is missing, the
  1096.                     previewer displays a dialog box that asks whether
  1097.                     to display the file anyway.
  1098.  
  1099.                     Unlike the ----ppppssssccccaaaannnn option, this resource must be an
  1100.                     integer. Scale factors (m and k) cannot be used.
  1101.                     If _p_r_e_S_c_a_n_S_i_z_e is greater than 100 Mbytes, an
  1102.                     error message results. If _p_r_e_S_c_a_n_S_i_z_e is zero, the
  1103.                     previewer skips the pre-scan and assumes that the
  1104.                     PostScript identifier string starts in the first
  1105.                     position in the first line of the file. The
  1106.                     default value (8200) allows for the common case in
  1107.                     which the header size is 8192 bytes.
  1108.  
  1109.           _p_r_o_l_o_g_F_i_l_e
  1110.              Type: string; Default: _n_o_n_e
  1111.              Option: ----ppppssss
  1112.  
  1113.              Description:  Sets the pathname to an external PostScript
  1114.                     prolog file. The previewer sends this file to the
  1115.                     Display PostScript context after the internal
  1116.  
  1117.  
  1118.  
  1119.      Page 17                                         (printed 4/30/98)
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.      SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))          AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444))))           SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))
  1127.  
  1128.  
  1129.  
  1130.                     prolog and before the PostScript file. This
  1131.                     resource can be used to implement stubs for site-
  1132.                     specific ssssttttaaaattttuuuussssddddiiiicccctttt operators, which may be used
  1133.                     in PostScript files at certain sites.
  1134.  
  1135.           _r_e_a_d_F_r_o_m_S_t_a_n_d_a_r_d_I_n_p_u_t
  1136.              Type: boolean; Default: False
  1137.  
  1138.              Description:  Determines whether the program reads from
  1139.                     _s_t_d_i_n by default, or only when the "-" option is
  1140.                     used.
  1141.  
  1142.                     If the "-" option is used to read from _s_t_d_i_n, or
  1143.                     if the _r_e_a_d_F_r_o_m_S_t_a_n_d_a_r_d_I_n_p_u_t resource is True, the
  1144.                     program may have to allocate a temporary file
  1145.                     during processing of _s_t_d_i_n.  By default, the file
  1146.                     is placed in /_t_m_p and deleted automatically when
  1147.                     it is no longer needed. Use the _t_e_m_p_D_i_r resource
  1148.                     or the ----ttttddddiiiirrrr option to change the default
  1149.                     directory.
  1150.  
  1151.           _r_e_p_o_s_i_t_i_o_n_E_P_S_F
  1152.              Type: boolean; Default: True
  1153.              Option: ----rrrreeeeppppssssffff; Menu: Reposition EPS Files
  1154.  
  1155.              Description:  Determines whether the program places the
  1156.                     upper left corner of an EPS image in the upper
  1157.                     left corner of the page.
  1158.  
  1159.           _s_c_a_l_e
  1160.              Type: float; Default: 1.0
  1161.              Option: ----sssscccc; Menu: Scale Selection Panel
  1162.  
  1163.              Description: Allows you to select the initial scale
  1164.                     factor at which to view documents.
  1165.  
  1166.           _s_k_i_p_C_o_p_y_r_i_g_h_t
  1167.              Type: boolean; Default: False
  1168.              Option: ----sssskkkkiiiippppcccc
  1169.  
  1170.              Description:  Instructs the program to bypass the display
  1171.                     of the copyright notice upon startup.
  1172.  
  1173.           _s_u_b_s_t_i_t_u_t_e_F_o_n_t_s
  1174.              Type: boolean; Default: True
  1175.              Option: ----ssssffff; Menu: Substitute Fonts
  1176.  
  1177.              Description:  Instructs the program to substitute Courier
  1178.                     for any missing fonts.
  1179.  
  1180.           _t_e_m_p_D_i_r
  1181.              Type: string; Default: /tmp
  1182.  
  1183.  
  1184.  
  1185.      Page 18                                         (printed 4/30/98)
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.      SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))          AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444))))           SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))
  1193.  
  1194.  
  1195.  
  1196.              Option: ----ttttddddiiiirrrr _d_i_r
  1197.  
  1198.              Description: When the previewer reads from _s_t_d_i_n, it
  1199.                     temporarily stores the input in the directory
  1200.                     specified by _t_e_m_p_D_i_r and later removes it.
  1201.  
  1202.           _v_e_r_b_o_s_e
  1203.              Type: boolean; Default: False
  1204.              Option: ----vvvv
  1205.  
  1206.              Description: When you set this resource to True, the
  1207.                     program prints a short message to _s_t_d_e_r_r each time
  1208.                     an error dialog box is displayed.
  1209.  
  1210.           _w_a_t_c_h_P_r_o_g_r_e_s_s
  1211.              Type: boolean; Default: False
  1212.              Option: ----wwwwpppp; Menu: Watch Progress
  1213.  
  1214.              Description: Instructs the program to update the display
  1215.                     while rendering is in progress instead of waiting
  1216.                     for a page to complete before displaying any of
  1217.                     it.
  1218.  
  1219.         DDDDiiiissssppppllllaaaayyyy PPPPoooossssttttSSSSccccrrrriiiipppptttt NNNNXXXX XXXX RRRReeeessssoooouuuurrrrcccceeeessss
  1220.           The following X resources are used to coordinate the Adobe
  1221.           ShowPS application with the Display PostScript NX software.
  1222.           See the Display PostScript NX documentation for more
  1223.           information.
  1224.  
  1225.           _d_p_s_n_x_A_g_e_n_t
  1226.              Type: string; Default: _n_o_t _s_e_t
  1227.  
  1228.              Description: Selects Display PostScript NX agent to
  1229.                     connect to. When this resource is not set, the
  1230.                     Display PostScript NX agent default is used.
  1231.                     String format: [_h_o_s_t_n_a_m_e]:[:]_p_o_r_t_n_u_m_b_e_r
  1232.  
  1233.           _d_p_s_n_x_A_g_e_n_t_E_x_e_c
  1234.              Type: string; Default: /_u_s_r/_b_i_n/_X_1_1/_d_p_s_n_x._a_g_e_n_t
  1235.  
  1236.              Description: Sets path to executable Display PostScript
  1237.                     NX agent.
  1238.  
  1239.           _d_p_s_n_x_D_e_b_u_g_L_e_v_e_l
  1240.              Type: int; Default: 0
  1241.  
  1242.              Description: Sets debug level for Display PostScript NX
  1243.                     agent.
  1244.  
  1245.           _d_p_s_n_x_E_x_t_r_a_S_t_a_c_k
  1246.              Type: int; Default: 0
  1247.  
  1248.  
  1249.  
  1250.  
  1251.      Page 19                                         (printed 4/30/98)
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.      SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))          AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444))))           SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))
  1259.  
  1260.  
  1261.  
  1262.              Description: Adds extra stackspace for Display PostScript
  1263.                     contexts.
  1264.  
  1265.           _d_p_s_n_x_L_i_n_g_e_r_T_i_m_e
  1266.              Type: string; Default: 0:05
  1267.  
  1268.              Description: Sets the linger time, in [_h_h:_m_m] format, for
  1269.                     the NX agent. Linger time is the time the agent
  1270.                     listens for new connections before it disconnects.
  1271.                     Default is five minutes.
  1272.  
  1273.           _d_p_s_n_x_N_o_L_o_g
  1274.              Type: boolean; Default: False
  1275.  
  1276.              Description: Sends Display PostScript NX debug log info
  1277.                     to _s_t_d_e_r_r.
  1278.  
  1279.           _d_p_s_n_x_P_S_R_e_s_D_i_r
  1280.              Type: string; Default: _n_o_t _s_e_t
  1281.  
  1282.              Description: Sets path to Display PostScript NX agent
  1283.                     resource directory. Typical value is
  1284.                     /_u_s_r/_l_i_b/_X_1_1/_D_P_S. When this resource is not set,
  1285.                     the Display PostScript NX agent default is used.
  1286.  
  1287.           _d_p_s_n_x_P_i_x_M_a_p_M_e_m_o_r_y
  1288.              Type: string; Default: _n_o_t _s_e_t
  1289.  
  1290.              Description: Sets use of pixmaps for Display PostScript
  1291.                     NX agent. One of three arguments can be used:
  1292.                     _l_i_m_i_t_e_d, _m_o_d_e_r_a_t_e, or _u_n_l_i_m_i_t_e_d. When this
  1293.                     resource is not set, the Display PostScript NX
  1294.                     agent default is used.
  1295.  
  1296.           _d_p_s_n_x_P_o_r_t_N_u_m_b_e_r
  1297.              Type: int; Default: _n_o_t _s_e_t
  1298.  
  1299.              Description: Sets port number for the Display PostScript
  1300.                     NX agent. When this resource is not set, the
  1301.                     Display PostScript NX agent default is used.
  1302.  
  1303.           _d_p_s_n_x_Q_u_a_n_t_u_m
  1304.              Type: int; Default: 1000
  1305.  
  1306.              Description: Sets operator quantum for the Display
  1307.                     PostScript NX agent.
  1308.  
  1309.           _d_p_s_n_x_S_y_n_c_h_r_o_n_o_u_s
  1310.              Type: boolean; Default: False
  1311.  
  1312.              Description: Sets synchronous mode in the Display
  1313.                     PostScript NX agent.
  1314.  
  1315.  
  1316.  
  1317.      Page 20                                         (printed 4/30/98)
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.      SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))          AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444))))           SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))
  1325.  
  1326.  
  1327.  
  1328.           _d_p_s_n_x_T_r_a_n_s_p_o_r_t
  1329.              Type: string; Default: _n_o_t _s_e_t
  1330.  
  1331.              Description: Sets Display PostScript NX agent transport
  1332.                     protocol. Values are limited to one of the
  1333.                     following: _t_c_p, _u_n_i_x, or When this resource is not
  1334.                     set, the Display PostScript NX agent default is
  1335.                     used.
  1336.  
  1337.           _d_p_s_n_x_U_s_e_X_F_o_n_t_s
  1338.              Type: boolean; Default: False
  1339.  
  1340.              Description: Causes the Display PostScript NX agent to
  1341.                     use X11 fonts instead of Type 1 fonts for small
  1342.                     sizes.
  1343.  
  1344.      BBBBUUUUGGGGSSSS
  1345.           If you are using a grayscale monitor and color pages are
  1346.           displaying poorly -- for example, if shades of red and blue
  1347.           are indistinguishable -- your X server is most likely
  1348.           misconfigured as a color server.  This problem frequently
  1349.           manifests itself on SPARCstation X servers.  Adding the
  1350.           option ----cccccccc 1111 to the command line that invokes your X server
  1351.           usually corrects the problem.
  1352.  
  1353.           If this does not work, or if you are unable to change your X
  1354.           server invocation, add the following lines to your
  1355.           ._X_d_e_f_a_u_l_t_s file:
  1356.  
  1357.              DPSColorCube.PseudoColor.8.reds: 0
  1358.              DPSColorCube.PseudoColor.8.grays: 17
  1359.  
  1360.           For more information, see ddddppppssss(1).
  1361.  
  1362.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  1363.           ttttrrrraaaannnnssssccccrrrriiiipppptttt(1), ffffiiiilllltttteeeerrrrppppssss(1), eeeennnnssssccccrrrriiiipppptttt(1)
  1364.  
  1365.           [1] O'Reilly & Assoc., _T_h_e _D_e_f_i_n_i_t_i_v_e _G_u_i_d_e_s _t_o _t_h_e _X _W_i_n_d_o_w
  1366.           _S_y_s_t_e_m, Vol. 0-7.
  1367.  
  1368.           [2] Adobe Systems Incorporated, _P_r_o_g_r_a_m_m_i_n_g _t_h_e _D_i_s_p_l_a_y
  1369.           _P_o_s_t_S_c_r_i_p_t _S_y_s_t_e_m _w_i_t_h _X (Addison-Wesley Publishing Co.,
  1370.           1993).
  1371.  
  1372.           [3] Adobe Systems Incorporated, _P_o_s_t_S_c_r_i_p_t _L_a_n_g_u_a_g_e
  1373.           _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, Second Edition (Addison-Wesley Publishing
  1374.           Co., 1990).
  1375.  
  1376.      NNNNOOOOTTTTEEEESSSS
  1377.           Copyright 1991, 1992 Adobe Systems Incorporated. All Rights
  1378.           Reserved.
  1379.  
  1380.  
  1381.  
  1382.  
  1383.      Page 21                                         (printed 4/30/98)
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.      SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))          AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444))))           SSSSHHHHOOOOWWWWPPPPSSSS((((1111))))
  1391.  
  1392.  
  1393.  
  1394.           Adobe, Adobe ShowPS, PostScript, Display PostScript, and
  1395.           TranScript are trademarks of Adobe Systems Incorporated
  1396.           which may be registered in certain jurisdictions.
  1397.  
  1398.           Motif is a trademark of the Open Software Foundation, Inc.
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.      Page 22                                         (printed 4/30/98)
  1450.  
  1451.  
  1452.  
  1453.